home *** CD-ROM | disk | FTP | other *** search
/ Adventure Games / Adventure Games 1.iso / winadv / winadv.txt < prev    next >
Encoding:
Text File  |  1997-08-12  |  11.5 KB  |  244 lines
  1. WINADV 2.1
  2. Colossal Cave
  3. Adventure
  4. for Windows 3
  5. (550 point version)
  6.  
  7. Wolfgang Strobl, strobl@gmd.de
  8.  
  9. WINADV is a port of the classical Colossal Cave text adventure to Windows 3. It is the 
  10. result of a few nights work based on the source code of a pure text mode Unix program  
  11. downloaded from one of the ftp servers carrying sources.
  12.  
  13. I added a few GUI bells and whistles to the game, but tried to maintain the original look & 
  14. feel at the same time. While it is still possible to play the game using keyboard commands 
  15. only, the addition of a few buttons for the most common command verbs, and a resizeable and 
  16. scrollable output window (based on Alan Phillips TextView DLL) makes the play much more 
  17. comfortable.
  18.  
  19. Sometimes this mixture of two user interfaces is a bit confusing. For example pushing the 
  20. "quit"-button triggers the question "Do you really want to quit now?" in the output window, 
  21. and has to be answered with "yes" or "no", either using one of the buttons labeled "yes" and 
  22. "no", or by typing "yes" or "no" into the input window and hitting the Enter key (or pushing 
  23. the OK button). 
  24.  
  25. Instead of giving the dreaded "This program requires Windows" message, WINADV runs the text 
  26. based DOS equivalent of the game, when called from the DOS command prompt.
  27.  
  28. Installation
  29.  
  30. The game consists of six files contained in one archive file:
  31.  
  32. WINADV.EXE        the game program, for both DOS and Windows
  33. TEXTVIEW.DLL        Alan Phillips TextView DLL,
  34. ADV.KEY        Game database
  35. ADV.REC             "
  36. WINADV.WRI        this file, documentation
  37. README.1ST          as it says
  38.  
  39. Copy all files into a fresh subdirectory and run WINADV from there. It is a good idea to 
  40. move the TEXTVIEW DLL to the Windows system directory (\WINDOWS\SYSTEM, usually), if it 
  41. isn't already there. Add WINADV.EXE to the games group of the program manager. WINADV 
  42. needs the two game database files ADV.KEY and ADV.REC in its current directory).
  43.  
  44. Running the game
  45.  
  46. Start the game, for example by double clicking on its icon in the program manager. It creates
  47.  the main window (which contains  part of a nice black and white picture of a dragon, from 
  48. M.C.Escher). Now two additional windows get created: one called "WinAdv - Output window", 
  49. which contains the game messages in black letters and your input in blue letters, and another 
  50. one called "WinAdv - Input window" which allows keyboard input of commands. 
  51.  
  52. Saving and reloading the state of the game
  53.  
  54. As described in the answer to the "info" command, you can stop the game and save the actual 
  55. state by using the "save" command in order to restore it at a later time.
  56.  
  57. Saving the content of the output window
  58.  
  59. The output window has a menu entry "File" with one subentry "Save". It causes the current 
  60. content of the output window to be saved into a file "ADVTRCnn.TXT" in the current directory, 
  61. where nn is the smallest two digit number so that a file with that name doesn't already exist. 
  62. I.e. successive calls of "Save" result in files named ADVTRC01.TXT, ADVTRC02.TXT and so on. 
  63. The whole output window content including the parts which have scrolled away will be saved. 
  64.  
  65. Don't confuse this with the "save" command within the game itself. The output window save 
  66. file is just a hardcopy of what you played, while the save command (given by typing it into 
  67. the input window) gives you the ability to restore the game state, later, but doesn't show 
  68. how you got there.
  69.  
  70. The output window
  71.  
  72. The output window as a "Scrolling" menu entry, which allowes "Automatic" and "Manual" scrolling.
  73.  The initial state is Automatic, which essentially mimics the behavior of a scrolling ascii
  74.  text terminal, where the last n lines of output are visible. Setting the mode to "Manual" 
  75. adds a vertical scroll bar, which allows scrolling back and forth and to inspect previous 
  76. lines of output, up to the initial greeting messages. The output windows has place for 2000 
  77. output lines, if enough memory is available.
  78.  
  79. The scrolling mode of the output window is forced to be "Automatic", if the input window gets 
  80. the keyboard focus back. This is because the current implementation of the TextView window 
  81. (the output window) isn't able to store lines when in "Manual" mode.
  82.  
  83. The output window uses the system font by default. The font and its size can be changed using 
  84. the "Font..." menu entry in the main window, if WinAdv is running under Windows 3.1 or Windows 
  85. 3.0 with an installed COMMDLG.DLL library. After selecting a different font or size (attributs 
  86. like bold or italic are ignored), the output window is closed and recreated using the just 
  87. selected font. Unfortunately, this implicitly discards the output window content. So be 
  88. carefull - save the output window content in a file, if you need it, before you change its font.
  89.  
  90. The attributes of the selected font are stored in a file WINADV.INI in the Windows directory 
  91. and are used for later games.
  92.  
  93. The output window is resizeable. The actual width of the output window will be remembered for 
  94. later use in WINADV.INI, when you quit the game.
  95.  
  96. Technical notes
  97.  
  98. The executable WINADV.EXE contains both the DOS and the Windows version of the game interpreter. 
  99. If you start it from within a DOS box, it will run as a DOS program in line mode. Both versions 
  100. use the same game database (adv.key and adv.rec).
  101.  
  102. Status of the game
  103.  
  104. The Colossal Cave adventure game is public domain, as far as I know. WINADV.EXE and this 
  105. documentation ("the archive") , i.e. the port of the game to Windows is 
  106. ╕ Copyright 1991, 1992 by Wolfgang Strobl, all rights reserved,
  107. Distribution of this program is granted, if the collection of the six files (see "Installation") 
  108. is distributed together and no part is modified and no money is charged for it. It is only 
  109. allowed to distribute this program, if the recipient has the right to distribute this program 
  110. further. It is explicitly forbidden to distribute this program, if the recipient isn't allowed 
  111. to distribute the game either as copy of the archive, or as full copy of the medium (floppy 
  112. disk, for example) he or she got the game on, at the recipients choice. The inclusion of this 
  113. program into a collections of programs implies that the distributor of the collection implies
  114.  this permission to copy.
  115.  
  116. If you like the game, drop me a postcard with the picture of a bicycle (really!):
  117.  
  118.     Wolfgang Strobl 
  119.     Argelanderstraße 92
  120.     D-5300 Bonn 1
  121.     Germany
  122.  
  123.  
  124. ______________________________________________________________________
  125.  
  126. The TextView DLL is ╕ Alan Phillips 1991.
  127.  
  128. I have included the release note from the author who wrote the source code on which I based my 
  129. Windows port (Ken C. Wellsch) at the end of this document.
  130.  
  131. History of WinAdv
  132.  
  133. Version 1     Initial release. Unfortunately, the sources that where the base of this port 
  134. where broken, making playing the game more difficult than it should have been. A second attempt 
  135. to start with the original Fortran sources failed because none of the Fortran to C converters 
  136. I have access to understood the ancient programming style this game was written in.
  137.  
  138. Version 2    is based on a different sources. This should fix most problems with the game 
  139. itself.
  140.  
  141. Version 2.1    A font selection dialog has been added, and the width of the output window 
  142. is now remembered in WINADV.INI. Manual editing of WINADV.INI shouldn't be necessary, anymore. 
  143. The font dialog requires the COMMDLG.DLL (standard on Windows 3.1). I don't own the Windows 3.1 
  144. SDK (I've reengineered the COMMDLG.DLL interface only), so I can't supply the COMMDLG.DLL with 
  145. this game. 
  146.  
  147.     The game windows can be brought to top just by starting it a second time, for example 
  148. by doubleclicking it in the Program Manager. This works whether the game is iconized or not.
  149.  
  150.  
  151. Release note for the game sources
  152.  
  153. From kcwellsch@watdragon.UUCP (Ken C. Wellsch) Mon Jul  7 15:10:06 1986
  154. Path: beno!seismo!caip!clyde!watmath!watnot!watdragon!kcwellsch
  155. From: kcwellsch@watdragon.UUCP (Ken C. Wellsch)
  156. Newsgroups: net.sources.games
  157. Subject: Adventure -- part 0 of 7
  158. Message-ID: <1182@watdragon.UUCP>
  159. Date: 7 Jul 86 19:10:06 GMT
  160. Reply-To: kcwellsch@watdragon.UUCP (Ken C. Wellsch)
  161. Organization: U of Waterloo, Ontario
  162. Lines: 81
  163.  
  164. I have been meaning to submit this game for some time but never seemed
  165. to find time to do it. This version of Adventure is taken from a Zerox
  166. Sigma-9 (rest her soul!), originally written by Dave Platt of Honeywell
  167. under CP-V (in Fort-77). I rewrote it into Ratfor many years ago and a
  168. couple years ago rewrote it again in C. This is the 550 point version
  169. of Adventure (for those who only know the 350 point original).
  170.  
  171. I had a lot of fun playing it on the SIGMA-9, and rewriting it, I hope
  172. you enjoy it too! Watch out, having the database can certainly ruin
  173. the game if you look at it!
  174.  
  175. The system components such as restricting the programs use etc. have
  176. been left incomplete. I had done them back in the old Ratfor version
  177. under V7 but each system can be quite different about determining load
  178. etc. so I didn't bother (a lame excuse I know).
  179.  
  180. +--------------------------------------------------------------------------
  181. |
  182. |                       CP-V Adventure
  183. |
  184. |    Originally written by David Platt (from the 350 point Adventure),
  185. |    UNIX C Version written by Ken Wellsch, with several modifications.
  186. |
  187. |    Original release notice from 12/1/79:
  188. |
  189. |        FOR THE OFFICIAL STUFF: PERMISSION IS HEREBY GRANTED TO ALL
  190. |        USERS TO POSSESS, USE, COPY, DISTRIBUTE, AND MODIFY (BUT NOT
  191. |        TO SELL) THE PROGRAMS AND FILES IN THIS PACKAGE.
  192. |
  193. |        IF YOU HAVE ANY PROBLEMS GETTING THIS TURKEY INSTALLED, FEEL
  194. |        FREE TO WRITE OR CALL - AND HAVE FUN, FOLKS
  195. |
  196. |            DAVID PLATT
  197. |            HONEYWELL LOS ANGELES DEVELOPMENT CENTER
  198. |            5250 WEST CENTURY BOULEVARD
  199. |            LOS ANGELES, CALIFORNIA  90045
  200. |            (213) 649-6870 x253
  201. |            HVN 369-1253
  202. |
  203. |    Current release notice as of 8/11/85:
  204. |
  205. |       Permission is hereby granted to all users to possess, use, copy,
  206. |       distribute, and modify the programs and files in this package
  207. |       provided it is not for direct commercial benefit and secondly,
  208. |       that this notice and all modification information be maintained
  209. |       along with the package.
  210. |
  211. |            Ken Wellsch
  212. |            University of Waterloo
  213. |            CS Graduate Department
  214. |            Waterloo, Ontario  N2l 3G1
  215. |            (519) 888-4518
  216. |
  217. |
  218. |History:
  219. |
  220. |      1979 winter:
  221. |            -- Running on XEROX SIGMA-9 under CP-V.
  222. |               Written in Fortran-77 by David Platt.
  223. |
  224. |      1982 winter:
  225. |            -- Completely rewritten for PDP 11/44 under UNIX Version 7.
  226. |               Written in Rational FORTRAN (ratfor) by Ken Wellsch.
  227. |      1984 fall:
  228. |            -- Once again rewritten, this time for a VAX 11/780,
  229. |               under UNIX BSD 4.2. Written in C by Ken Wellsch.
  230. |
  231. |
  232. |       Copyright (c) 1979 David Platt    Database & Methods
  233. |       Copyright (c) 1984 Ken Wellsch    C Code & Modifications
  234. |
  235. +--------------------------------------------------------------------------
  236.  
  237. --
  238.  
  239. ------------------------------------------------------------------------------
  240. -- Ken C. Wellsch, CS Dept., U. Waterloo, Waterloo, Ontario, Canada N2L 3G1 --
  241. CSNET:kcwellsch%watdragon@waterloo.csnet                   HOME:1-519-746-4984
  242. ARPA :kcwellsch%watdragon%waterloo.csnet@csnet-relay.arpa  OFFI:1-519-888-4518
  243. UUCP :...!{allegra|clyde|linus|utzoo|inhp4|decvax}!watmath!watdragon!kcwellsch
  244. ------------------------------------------------------------------------------